domainCHECK Request
Function
This request is used to find out about the status of a domain.
Requirements
None.
Request Parameters
Contact CHECK request comprises the parameters described below:
| K/V Keyword | XML Namespace and Element | Occurrence min - max |
Type / Length | Value Range | Description |
|---|---|---|---|---|---|
| Action | domain:check | 1 | enumeration | check-erule | This is the request type. |
| Version | - | 1 | enumeration | version-erule | This is the version. The keyword is only relevant for requests in the key/value format. |
| Domain | domain:handle | 1 | token 4 - 66 |
domain-rule | This is the domain name. |
| Domain-Ace | domain:ace | 0 - 1 | token 4 - 66 |
domainace-rule | This is the ACE form (ASCII Compatible Encoding) of the domain name. |
Examples
- xml
- k/v
Copy
format: xml
request: domainCHECK
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<registry-request xmlns="http://registry.denic.de/global/5.0" xmlns:domain="http://registry.denic.de/domain/5.0">
<domain:check>
<domain:handle>de-example.de</domain:handle>
</domain:check>
</registry-request>
Copy
format: xml
response: domainCHECK
<?xml version="1.0" encoding="UTF-8"?>
<registry-response xmlns="http://registry.denic.de/global/5.0" xmlns:tr="http://registry.denic.de/transaction/5.0">
<tr:transaction>
<tr:stid>9e986503-9a2c-11df-a9e2-9519b5688882</tr:stid>
<tr:result>success</tr:result>
<tr:data>
<domain:checkData xmlns:domain="http://registry.denic.de/domain/5.0">
<domain:handle>test.de</domain:handle>
<domain:status>connect</domain:status>
</domain:checkData>
</tr:data>
</tr:transaction>
</registry-response>
Copy
format: xml
response: domainCHECK
status: pendigCreate
<registry-response xmlns="http://registry.denic.de/global/5.0" xmlns:tr="http://registry.denic.de/transaction/5.0">
<tr:transaction>
<tr:stid>0a38e709-33e3-d5cf-cccf-622f9a16f225</tr:stid>
<tr:result>success</tr:result>
<tr:data>
<domain:checkData xmlns:domain="http://registry.denic.de/domain/5.0">
<domain:handle>de-example.de</domain:handle>
<domain:ace>de-example.de</domain:ace>
<domain:status>pendingCreate</domain:status>
</domain:checkData>
</tr:data>
</tr:transaction>
</registry-response>
Copy
format: xml
response: domainCHECK
status: serverHold
<registry-response xmlns="http://registry.denic.de/global/5.0" xmlns:tr="http://registry.denic.de/transaction/5.0">
<tr:transaction>
<tr:stid>0a38e709-33e3-d5cf-cccf-622f9a16f225</tr:stid>
<tr:result>success</tr:result>
<tr:data>
<domain:checkData xmlns:domain="http://registry.denic.de/domain/5.0">
<domain:handle>denic-server-hold.de</domain:handle>
<domain:ace>denic-server-hold.de</domain:ace>
<domain:status>serverHold</domain:status>
</domain:checkData>
</tr:data>
</tr:transaction>
</registry-response>
Copy
format: k/v
response: domainCHECK
Result: success
STID: 74ba5119-74d1-4ba6-935f-4feb07ddd14d
Domain: de-example.de
Status: exist
Copy
format: k/v
response: domainCHECK
status: pendigCreate
Result: success
STID: 74ba5119-74d1-4ba6-935f-4feb07ddd14d
Domain: de-example.de
Domain-Ace: de-example.de
Status: pendigCreate
Copy
format: k/v
response: domainCHECK
status: serverHold
Result: success
STID: 74ba5119-74d1-4ba6-935f-4feb07ddd14d
Domain: de-example.de
Domain-Ace: de-example.de
Status: serverHold